Dev doc: Document the maxCompiledUnitsAtOnce setting in Eclipse This setting is needed to make annotation processing work reliably. See the related discussion on repo-discuss: https://groups.google.com/d/msg/repo-discuss/rpv-ElAWr2Y/CbXj6NL2BwAJ Change-Id: I7cf967a2207b6c9e5dd75de3647be3a71c9db948
diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt index 51c0bcd..b8d01e8 100644 --- a/Documentation/dev-eclipse.txt +++ b/Documentation/dev-eclipse.txt
@@ -10,6 +10,20 @@ [[setup]] == Project Setup +In your Eclipse installation's `eclipse.ini` file, add the following line in +the `vmargs` section: + +---- + -DmaxCompiledUnitsAtOnce=10000 +---- + +Without this setting, annotation processing does not work reliably and the +build is likely to fail with errors like: + +---- + Could not write generated class ... javax.annotation.processing.FilerException: Source file already created +---- + In Eclipse, choose 'Import existing project' and select the `gerrit` project from the current working directory.
